# tap.onShareMessage(function listener)
以 Promise 风格调用:不支持
# 功能描述
监听分享行为,可以在此修正分享内容
# 参数
# function listener
分享行为监听函数
# 回调参数
# function resolve
resolve 是 onShareMessage 监听的首个回调参数,是一个接口函数。
当用户点击分享渠道时,容器会调用注册的 listener 监听,并等待 resolve 返回
游戏调用 resolve({ /* 分享参数 */ }) 后,分享行为继续进行
# string channel
channel 是 onShareMessage 监听的第二个回调参数,表示被点击的分享渠道
# resolve
的 回调参数
属性 | 类型 | 默认值 | 必填 | 说明 |
title | string | 否 | 分享标题 | |
desc | string | 否 | 分享文案 | |
success | function | 否 | 分享成功的回调函数 | |
fail | function | 否 | 分享失败的回调函数 | |
complete | function | 否 | 分享结束的回调函数(调用成功、失败都会执行) |
# success
、 fail
和 complete
回调函数
# 参数
# Object res
属性 | 类型 | 说明 |
errMsg | String | 错误信息 |
errno | Number | errno 错误码,错误码的详细说明参考 Errno错误码 |
# 示例代码
// 当监听到用户点击了某个分享渠道
tap.onShareAppMessage(function (resolve, channel) {
// 分享渠道
console.log(channel);
// 自定义分享内容
resolve({
title: "分享标题",
desc: "分享内容",
query: "k1=v1&k2=v2",
success(res) {
console.log("分享成功");
},
fail(res) {
console.log("分享失败", res.errMsg);
}
});
});